Audio experience

An audio experience allows visitors to listen to your written content which combines an audio player and audio track generated from the JWX Studio.

To implement an audio experience, you must:

• Create JWX Studio article-to-audio projects, tailored to read your article verbatim or use prompting to create a unique summary
• Setup a Dynamic Strategy Rule (DSR) strategy with an Audio Experience
• Embed a DSR rule placement with the KVPs matching the JWX Studio project

Prerequisites

Set up an audio experience

To set up an audio experience, you must create an audio experience and define the key for retrieving Studio media.

Create an audio experience

Follow these steps to create an audio experience:

1. On the decision tree, click + Add experience > Audio experience. The audio experience creation page appears.

2. Under Audio experience, enter a Name. This will appear as the identifier of the node in the decision tree.

3. Under General, select the JWX Studio Project delivery key.

   🚧

   This key must be the same key used to set custom data for the Dynamic Strategy Rule placement. JWX uses this key to match a value from the page to the External ID in JWX Studio.

4. Under Branding, configure the player display options.

   Setting	Description
   Display mode	Controls the audio player layout and available UI elements Options: Simple displays a minimal set of controls, including play/pause, the progress bar, and timestamps Standard displays the full set of player controls For details about the UI elements and customization options available in each layout, see the Audio Experience Customization Reference.
   Powered by JWX signature	Shows or hides the Powered by JWX signature Enabled by default.
   Listen CTA state	Controls whether the audio engagement state appears before playback starts

5. (Optional) Configure advertising.

   ⚠️

   For display ads, in addition to configuring the settings below, create the applicable display line items in JWX Ad Server.

   Setting	Description
   Audio ads	Plays preroll and midroll audio ads and controls ad timing Follow these steps: Click the toggle to ON. The section expands. Enable one or both Ad events. Preroll Select Preroll. The Ad tag URL field appears. Enter an Ad tag URL. Midroll Select Midroll. The Ad tag URL field appears. Enter an Ad tag URL. Enter the Minimum time before first midroll in seconds. Under Ad settings, set Minimum time between ads in seconds. The default is 15 seconds.
   Display ads	Displays ads that refresh at a configured interval Follow these steps: Click the toggle to ON. The section expands. Set the Refresh rate in seconds.

6. Click Done.

Define the key for retrieving Studio media

On the article page (on your site), set a key-value pair for your Dynamic Strategy Rule placement using one of the following methods.

// Append the following query parameter to the placement embed script.

?&custom.<placement-id>.<key>=<value>

<div
    id="jwp-placement-1"
    data-jw-placement-id="<placement-id>"
    data-jw-<key>="<value>">
</div>

const jwDataStore = window.jwDataStore || { custom: {} };
jwDataStore.custom.<placement-id> = { <key>: "<value>" };
window.jwDataStore = jwDataStore;